.TH E1432_SET_MULTI_SYNC 3 E1432
.SH NAME
.nf
e1432_set_multi_sync \- Set multiple module system synchronization
e1432_get_multi_sync \- Get current multiple module system sync state
.fi
.IX e1432_set_multi_sync(3) 3
.IX e1432_get_multi_sync(3) 3
.SH SYNOPSIS
.cS
SHORTSIZ16 e1432_set_multi_sync(E1432ID hw, SHORTSIZ16 ID,
                                SHORTSIZ16 sync)
SHORTSIZ16 e1432_get_multi_sync(E1432ID hw, SHORTSIZ16 ID,
                                SHORTSIZ16 *sync)
.cE
.SH DESCRIPTION
A typical measurement doesn't generally need to deal with
\fIe1432_set_multi_sync\fR at all.  Normally, the call to
\fIe1432_init_measure\fR automatically takes care of setting the
multi-module setups for all the modules in a measurement, by
internally calling \fIe1432_set_multi_sync\fR for each module.  This
automatic setup can be disabled using the
\fIe1432_set_auto_group_meas\fR function.

\fIe1432_set_multi_sync\fR sets the multiple module system
synchronization, of a single channel or group of channels \fIID\fR, to
the value given in \fIsync\fR.

\fIe1432_get_multi_sync\fR returns the current value of the multiple
module system synchronization, of a single channel or group of
channels \fIID\fR, into a memory location pointed to by \fIsync\fR.

This parameter is a "global" parameter.  It applies to an entire E1432
module rather than to one of its channels.  The \fIID\fR parameter is
used only to identify which module the function applies to, and all
channels in that module will report the same value for this parameter.

\fIhw\fR must be the result of a successful call to
\fIe1432_assign_channel_numbers\fR, and specifies the group of
hardware to talk to.

\fIID\fR is either the ID of a group of channels that was obtained with a
call to \fIe1432_create_channel_group\fR, or the ID of a single channel.

\fIsync\fR is used to select the synchronization.  The E1432 supports
synchronous operation among multiple E1432s by using a VXI TTLTRG line
to drive all the modules in a system from the same clock.
\fBE1432_MULTI_SYNC_OFF\fR sets the SYNC to be generated locally.
\fBE1432_MULTI_SYNC_ON\fR sets the module to use the SYNC line from
the VXI backplane, which is selected with
\fIe1432_set_ttltrg_satrg\fR.  This mode uses the SYNC line for
multiple module synchronization capabilities including: booting of the
digital filters, synchronization of the local oscillators, arming, and
triggering.

For backwards compatibility with the E1431 library, the following
obsolete values for \fIsync\fR are also accepted:
\fBE1432_SYSTEM_SYNC_OFF\fR, which is the same as
\fBE1432_MULTI_SYNC_OFF\fR; and \fBE1432_SYSTEM_SYNC_ON\fR, which is
the same as \fBE1432_MULTI_SYNC_ON\fR.
.SH "RESET VALUE"
After a reset, \fIsync\fR is set to \fBE1432_MULTI_SYNC_OFF\fR.
.SH "RETURN VALUE"
Return 0 if successful, a (negative) error number otherwise.
.SH "SEE ALSO"
.na
e1432_set_auto_group_meas, e1432_set_ttltrg_satrg
.ad
